home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / ezy_comm / eols102p.zip / EZYOLS.DOC < prev    next >
Text File  |  1992-11-03  |  13KB  |  501 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                            ------------------------
  30.  
  31.                                     Ezycom
  32.  
  33.  
  34.                            Obscene Language Scanner
  35.  
  36.  
  37.                                 By Jeff Clement
  38.  
  39.  
  40.                               (C) Copyright 1992
  41.  
  42.  
  43.                                  Version 1.02p
  44.  
  45.                            ------------------------
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                    CONTENTS
  71.  
  72.  
  73.  
  74.         Overview  . . . . . . . . . . . . . . . . . . . . . . . . . 3
  75.  
  76.         Terms and Conditions  . . . . . . . . . . . . . . . . . . . 3
  77.  
  78.         Features  . . . . . . . . . . . . . . . . . . . . . . . . . 3
  79.  
  80.         Installing the Program  . . . . . . . . . . . . . . . . . . 4
  81.  
  82.         Running the Program . . . . . . . . . . . . . . . . . . . . 6
  83.  
  84.         Information and Support . . . . . . . . . . . . . . . . . . 7
  85.  
  86.         Future  . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  87.  
  88.         Acknowledgments . . . . . . . . . . . . . . . . . . . . . . 7
  89.  
  90.         History of the Obscene Language Scanner . . . . . . . . . . 8
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.                                     Page 2
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.         OVERVIEW
  119.  
  120.         Ezycom Obscene Language Scanner (EZYOLS) will  scan your Ezycom
  121.         message base  for any  messages containing  language which  you
  122.         might consider to be obscene  and move them to  another message
  123.         area for the system operator's eyes only.
  124.  
  125.         Note: This version of EZYOLS is for use with Ezycom V1.02
  126.  
  127.  
  128.         TERMS AND CONDITIONS
  129.  
  130.         In  using  this program  agree  that  in  no  event shall  Jeff
  131.         Clement  be liable for any indirect, incidental, consequential,
  132.         special,  or exemplary  damage or  lost  profits, even  if Jeff
  133.         Clement have been advised  of the possibility  of such  damages
  134.         or lost profits. 
  135.  
  136.         This program  may be  freely distributed  provided the  program
  137.         remains  in its  original  condition  with the  original  files
  138.         distributed.
  139.  
  140.  
  141.         FEATURES
  142.  
  143.         *    Up to 20  keywords which can be  up to 10 characters  long
  144.              to scan for.
  145.  
  146.         *    Two  different  scan  methods:  a  complete  scan  of  all
  147.              messages  or  scan  messages  which  are   waiting  to  be
  148.              exported.
  149.  
  150.         *    Optionally  toggle on  or off  the  scanning of  specified
  151.              message areas.
  152.  
  153.         *    Easy to configure.  The config options are menu driven.
  154.  
  155.         *    32-Bit CRC password protection on configuration.
  156.  
  157.         *    Sysop  name is user  defined.  Messages found with obscene
  158.              language will be addressed to the sysop.
  159.  
  160.         *    Message  area  to move  the  messages  containing  obscene
  161.              language to is user defined.
  162.  
  163.         *    Messages containing obscene language  which are  addressed
  164.              to the sysop are always marked as private.
  165.  
  166.         *    Configuration file may not  be viewed from DOS.  ie. using
  167.              the  DOS  command  TYPE  won't  display  anything  in  the
  168.              configuration file.
  169.  
  170.         *    Works in a  network and multitasking environment (provided
  171.              that SHARE is loaded).
  172.  
  173.  
  174.  
  175.                                     Page 3
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.         INSTALLING THE PROGRAM
  184.  
  185.         1.   You may unarchive the program to the  directory where your
  186.              Ezycom    system   files    are   located   (MESSAGES.EZY,
  187.              CONSTANT.EZY and  CONFIG.EZY).  If  you wish to  unarchive
  188.              the files to  another directory,  you may  do so  provided
  189.              that you set  the EZY environment variable before  running
  190.              the program.  For example, type:
  191.  
  192.                   PKUNZIP EOLS102P.ZIP C:\EZY
  193.  
  194.         2.   Change to the directory where you  unarchived the program.
  195.              For example, type:
  196.  
  197.                    CD\EZY
  198.  
  199.         3.   Create  and modify  the  configuration using  the  -config
  200.              switch.  For example, type:
  201.  
  202.                   EZYOLS -CONFIG
  203.  
  204.         4.   You will  be then  required to  enter the  sysop name  you
  205.              wish to use and the  message area number to  move messages
  206.              containing obscene language to.
  207.  
  208.         5.   A  password will  have to be  entered next.   The password
  209.              can  be up  to  15 characters  long.   After  entering the
  210.              password, you  will have  to enter  the password  again to
  211.              verify that password entered originally is correct.
  212.  
  213.         6.   A menu  of options  will appear  which will  allow you  to
  214.              modify the configuration.  Select  option 1 to add  in key
  215.              words  which you consider to be obscene.  The words can be
  216.              up to 10  characters long (maximum of 20 words).  The more
  217.              words  you  enter,  the  longer  it  takes   to  scan  the
  218.              messages.   After you  have entered  your key words,  when
  219.              asked for  the next  word you  should leave  it blank  and
  220.              press Enter.
  221.  
  222.         7.   If you  need to toggle the  scanning of a  message area on
  223.              or off, select option 7.  You will be  required to enter a
  224.              range of  message areas to toggle.   To  check which areas
  225.              you  have toggled  on  and off  select  option 8  from the
  226.              menu.
  227.  
  228.         8.   If there  are any  other changes  needed, select  the menu
  229.              option.   Once you are finished,  select option  9 to quit
  230.              and save.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                     Page 4
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.         9.   You should  now modify  your batch  file to  run the  BBS.
  250.              The best way  to include EZYOLS  in you batch  file is  to
  251.              scan  messages  to be  exported  before you  use the  scan
  252.              option  on the mail processor (use the -EXPORT switch) and
  253.              to  scan   the  entire  message   base  in  your   nightly
  254.              maintenance (use the -ALL switch).  
  255.  
  256.              For example,  in the  part of  your batch  file where  you
  257.              scan for messages you could have:
  258.  
  259.                   :scanmail
  260.                   ezyols -export
  261.                   ezymail -scan -verbose
  262.                   ezynet -export
  263.  
  264.              In the  part of  your batch  file where  you perform  your
  265.              nightly maintenance you could have:
  266.  
  267.                   :night
  268.                   ezyols -all
  269.  
  270.              You  could possibly scan the entire message base after you
  271.              toss new mail provided  the message base isn't too big and
  272.              that your computer is fast enough.
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.                                     Page 5
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.         RUNNING THE PROGRAM
  314.  
  315.         WARNING: While  the program is scanning  the message base,  you
  316.         should NOT stop  the program at all -  doing so could result in
  317.         a  corrupted message base!  If you wish to use the program in a
  318.         network  or multitasking  environment, you  should  ensure that
  319.         SHARE  or  equivalent is  loaded else  you  could  corrupt your
  320.         message  base.    I cannot  guarantee  the  program  will  work
  321.         correctly  in   a  network  or  multitasking  environment,  but
  322.         provided no one else is online when it is being  executed there
  323.         should be no problems.
  324.  
  325.         There  are four  different command line parameters  you can use
  326.         when you run Ezycom Obscene Language Scanner.  These are:
  327.  
  328.         -ALL      This option  will scan all  the message areas  (which
  329.                   you have turned  on) for messages containing  obscene
  330.                   language   which    you   have    defined   in    the
  331.                   configuration.  This option can take several  minutes
  332.                   depending on the  size of your  message base  and the
  333.                   number  of key  words  to  scan for.    For  example,
  334.                   EZYOLS -ALL
  335.  
  336.         -EXPORT   This  option  will  scan  message  areas  (which  are
  337.                   turned  on) for  messages  which  are waiting  to  be
  338.                   exported  in the  message  base.   ie.  Echomail  and
  339.                   netmail  messages which haven't been  scanned by your
  340.                   mail processor.   Scanning messages this way is  much
  341.                   quicker  than scanning  the entire  message.   It  is
  342.                   recommended that you  use this option before you  use
  343.                   your mail processor  to "scan" your message base  for
  344.                   outgoing mail.  For example, EZYOLS -EXPORT
  345.  
  346.         -CONFIG   This  will  allow you  to  modify  your configuration
  347.                   provided that  a correct  password is  entered.   You
  348.                   may add,  delete and  list keywords  and turn  on/off
  349.                   scanning of message areas.
  350.  
  351.         -?        This shows  a brief help screen  on what  each of the
  352.                   command line parameters do.
  353.  
  354.         -NXXX     This  the node  number which  use  to program  under.
  355.                   The  program  will  also  use  the  TASK  environment
  356.                   variable if it has  been defined.  The node should be
  357.                   used if  you are  running a multiline system.   Note:
  358.                   You  should not use  this switch  as the first switch
  359.                   on the command line.
  360.  
  361.         The maintenance  log defined in  the Ezycom configuration  will
  362.         be used to log activity.
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.                                     Page 6
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.         INFORMATION AND SUPPORT
  379.  
  380.         If you  require any information or  help about  this program or
  381.         you have found an error, you should send e-mail to:
  382.  
  383.         Jeff Clement 
  384.         Fidonet  3:633/155.2
  385.         Internet clementex@brt.deakin.edu.au
  386.  
  387.         If you  have any ideas or  suggestions for  future versions and
  388.         would like  to share them  with me, please send  them to me  to
  389.         one of the e-mail addresses above.
  390.  
  391.         I hope to  have the latest  version of EZYOLS  to be  available
  392.         from most Ezycom support sites.
  393.  
  394.  
  395.         FUTURE
  396.  
  397.         There has been many suggestions  already made to me  for future
  398.         versions of EZYOLS.   Some of these include identifying the key
  399.         words  in a  message  by either  listing  the line  numbers the
  400.         words were found  on in a message or by emphasising the obscene
  401.         words somehow.   Other suggestions include sending a message to
  402.         the user who wrote  the obscene message and making the template
  403.         for a message user-defined.
  404.  
  405.  
  406.         ACKNOWLEDGMENTS
  407.  
  408.         Thank you to the  testers of previous versions of this program:
  409.         Roland  Gesthuizen,  Paul  Chandler,  Richard   Stocks,  Andrew
  410.         Doran, Peter Davies.
  411.  
  412.         Special  thanks  to   Peter  Davies  and  Richard  Stocks   for
  413.         supplying me with code, help and support which contributed  the
  414.         development of this program.
  415.  
  416.         Ezycom, EzyUnit and EzyInc is (C) 1992 Peter Davies
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.                                     Page 7
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.         HISTORY OF THE OBSCENE LANGUAGE SCANNER
  444.  
  445.         During 1991, I  was helping a teacher with  a BBS which  he had
  446.         set  up using  Remote Access.   He  approached me  one day  and
  447.         informed  me that  some of  his students  were writing messages
  448.         containing  obscene language  to other  students  in the  local
  449.         areas.   He  asked  me  if there  was  a  program to  find  any
  450.         messages  which  might contain  language  not  appropriate  for
  451.         school students to us.
  452.  
  453.         At the  time, we  were using  Remote Access,  and I  eventually
  454.         released version  1.00 of  OLSCAN (previously  called IDIOT  at
  455.         that  time).  I  improved on  the program  as time went  by and
  456.         eventually released version 1.02 of OLSCAN.
  457.  
  458.         During early  1992, Ezycom version  1.00 was  released and  our
  459.         points  decided to  change  over  to it.    We were  without  a
  460.         obscene  language scanner  once again, so  I decided  to make a
  461.         similar  program  for  Ezycom.    During  May  1992, the  first
  462.         version of Ezycom Obscene Language Scanner was released.
  463.  
  464.         1.00      Initial release.
  465.  
  466.         1.01      Fixed  quite  a  few bugs,  increased  the  speed  of
  467.                   accessing files, added code to make  the message base
  468.                   files   behave   in  a   network   and   multitasking
  469.                   environment, changed  the names of  the command  line
  470.                   parameters,   increased   the   speed   of   scanning
  471.                   slightly,  added  the use  of  the  maintenance  log,
  472.                   added node  command line parameter, and detection for
  473.                   DESQview.
  474.  
  475.         1.02p     Converted  the code  from 1.01  so  that it  could be
  476.                   used with Ezycom 1.02.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.                                     Page 8
  501.